PC Media 2

home *** CD-ROM | disk | FTP | other *** search

/ PC Media 2 / PC MEDIA CD02.iso / share / udos / ds_v1 / dirstat.doc next >

Wrap

Text File | 1992-10-22 | 20.0 KB | 488 lines

User Instructions for DirStat V1.00 - Revised 10/23/92 ===================================================================== DirStat V1.00 FreeWare Utility Program By Steve Dunn 50 Hillside Drive Hanover, MA. 02339 CompuServe ID: 70034,2454 ===================================================================== DISTRIBUTION: ------------ DirStat may be freely copied and used by you or anyone you know for any and all non-commercial purposes without payment of any fee, provided that you distribute BOTH DIRSTAT.EXE and DIRSTAT.DOC together without any modifications. This program remains my personal property, and is explicitly NOT being placed in the Public Domain. It is, instead, "FreeWare". --------------------------------------------------------------------- Legal Disclaimers: ----------------- YOU USE THIS SOFTWARE AT YOUR OWN RISK! UNDER NO CIRCUMSTANCES WILL I BE LIABLE TO YOU FOR ANY DAMAGES OF ANY SORT! THIS SOFTWARE CARRIES NO WARRANTY OF ANY TYPE, INCLUDING FITNESS FOR ANY PARTICULAR PURPOSE! I welcome your feedback, comments, criticisms, etc at any time - your best bet is to send CompuServe E:Mail to my ID (70034,2454) or hard-copy mail to me at the address on page one of this documentation. Please do not call me on the phone. User Instructions for DirStat V1.00 - Revised 10/23/92 Using DirStat ------------- DirStat is an easy to use utility that groups files in any given PATH by file EXTension and provides you with a means of analyzing and manipulating such groups of files. DirStat V1.00 is written for a color monitor, and may not be entirely useful on monochrome monitors (some color combinations may be difficult to read). If enough people request it, I'll offer a future version with the ability to switch between color and monochrome display attributes. DirStat V1.00 has an internal limit of 1,560 files per PATH and / or subdirectory. This limit is based on the programs internal design, and cannot be altered by the user. If this presents you with a real problems, let me know and I'll see about increasing it. (Although why would you want to have so many files in a single directory ?!?). User Instructions for DirStat V1.00 - Revised 10/23/92 Syntax and Command Line Parms: ----------------------------- DirStat should be invoked from the DOS command line using the following syntax: DIRSTAT [/?] | [d:][\path\] [/25] [/43] [/50] [CE] [/NC] All the above command line parms are OPTIONAL, and are defined as follows: /? - If these characters appear anywhere on your command line, DirStat will display a help screen for its syntax similar to what appears on this page. d: - The DOS DRIVE that you want DirStat to start off reading. If you omit this, DirStat will use the current default DOS DRIVE. \path\ - The DOS PATH you want DirStat to start off reading. If you omit this, DirStat will use the current default DOS PATH. - NOTE: Do NOT include a file specification on the command line! DirStat automatically adds "*.*" at run time. /25 - tells DirStat to start up in 25-rows-per screen mode. /43 - tells DirStat to start up in 43-rows-per screen mode. This requires an EGA or better. /50 - tells DirStat to start up in 50-rows-per screen display mode. This requires an VGA or better. NOTE: - You can also alter the number of rows per screen page from within DirStat at any point by using the F9 menu option, which provides a menu of available screen modes. NOTE: - If you use more than one of the above, DirStat will pick the largest value for the number of screen rows. NOTE: - DirStat will not check to see whether you have the necessary hardware before attempting to set the mode you want. If you don't have the physical hardware needed, you will get an error message. /CE - tells DirStat to clear the display screen on exit. Normally, DirStat leaves the last screen full of display data up when it exits. /NC - tells DirStat to NOT clear the screen on exit. User Instructions for DirStat V1.00 - Revised 10/23/92 Note that the /25, /43, /50, and the /CE parms can also be specified in a DOS ENVIRON string using the DOS command, SET, as in the following example: SET DIRSTAT=/CE/43 which changes the default behavior of DirStat such that it starts up in 43 rows per screen mode, and clears the screen on exit. Note that parms on the DOS command line will OVERRIDE the ENVIRON parms at run time, so that you do not need to alter your "DIRSTAT=" ENVIRON string merely to alter DirStat's default behavior. --------------------------------------------------------------------- DirStat is fully menu driven - the available functions are always displayed on the right hand side of the display screen. The following pages will detail what each menu function does. User Instructions for DirStat V1.00 - Revised 10/23/92 Detailed Instructions: --------------------- After invoking DirStat, a screen similar to the following will appear on the screen (the "Summary Data" screen): <*> Dirstat Directory Utility Program V1.00 - FreeWare by Steve Dunn <*> Path: F:\WIN31\*.* Files: 181 EXTs: 24 Bytes: 8,039,239 EXT # Smallest Biggest Total % ╓─────────────────────────╖ BMP 9 1,630 153,718 744,126 9.3 ║[*] DirStat Main Menu [*]║ GRP 6 810 13,739 34,396 0.4 ╟─────────────────────────╢ HLP 33 5,872 150,877 1,063,669 13.2 ║[F1] Sort by EXT ║ PIF 11 545 545 5,995 0.1 ║[F2] Sort by COUNT ║ WAV 28 8,546 171,658 960,246 11.9 ║[F3] Sort by SMALLEST ║ DAT 6 4 65,536 152,769 1.9 ║[F4] Sort by BIGGEST ║ EXE 41 3,744 452,096 4,212,564 52.4 ║[F5] Sort by TOTAL ║ INI 15 98 7,810 17,887 0.2 ║[F6] Sort ASCENDING ║ MID 1 33,883 33,883 33,883 0.4 ║[F7] Print data to FILE ║ ICO 1 766 766 766 0.0 ║[F8] Print data to LPT1 ║ SCR 9 5,328 62,688 178,944 2.2 ║[F9] Change Screen Rows ║ TRM 1 4,096 4,096 4,096 0.1 ║[F10] Show EXT DETAILS ║ ION 1 7,752 7,752 7,752 0.1 ╟─────────────────────────╢ DLL 5 6,766 271,264 424,812 5.3 ║[PGUP] Show Prev Page ║ TXT 2 2,956 41,724 44,680 0.6 ║[PGDN] Show Next Page ║ WPG 1 11,872 11,872 11,872 0.1 ║[HOME] Show 1st Page ║ SYS 2 5,873 13,824 19,697 0.2 ║[END] Show Last Page ║ L00 1 1,945 1,945 1,945 0.0 ║[INS] Read new PATH ║ P00 1 1,945 1,945 1,945 0.0 ║[ESC] Quit DirStat ║ COM 2 44,170 56,425 100,595 1.3 ╙─────────────────────────╜ Line 1: - The program name, version number, and personal plug! Line 2: - The DRIVE and PATH currently being displayed. Note that the "*.*" is added automatically for you and should NOT be included on the DOS command line. Line 3: - Summary data on the DRIVE and PATH hilighted on line 2 - Files = total number of files in the DRIVE and PATH, including Hidden, Read-Only, etc files. EXTs = the number of different and unique filename EXTensions found in the DRIVE and PATH. Bytes = the total number of bytes in all the files found in the DRIVE and PATH (this is the DOS File size, not the number of bytes in occupied disk clusters). Directly beneath this header data, on the left hand side of the screen, is summary data - one line for each different filename .EXTension found. User Instructions for DirStat V1.00 - Revised 10/23/92 The leftmost column (EXT) gives each individual EXT name. The next column (#) gives the number of files found in the DRIVE and PATH which have each EXTension. The next column (Smallest) gives the size, in bytes, of the smallest file bearing each individual EXTension. The next column (Biggest) gives the size, in bytes, of the largest file bearing each individual EXTension. The next column (Total) gives the total number of bytes found in all files bearing each individual EXTension. The last column (%) gives the percentage of bytes in all files of each individual EXTension compared to the total number of bytes found in ALL files. Note that, originally, this data is unsorted - the EXT names are presented in the order in which they are encountered in the DOS directory listing. The menu on the right hand side of the screen allows you to re-arrange the summary data into more useful formats, as follows: F6 - Switches SORT order between ascending and descending. F1 - Sorts the display alphabetically by the EXT name F2 - Sorts the display numerically by the COUNT (i.e., the number of files for each individual EXTension). F3 - Sorts the display numerically by the size of the smallest file found for each individual EXTension. F4 - Sorts the display numerically by the size of the largest file found for each individual EXTension. F5 - Sorts the display by the total number of bytes for all files found for each individual EXTension. F7 - Sends a copy of the summary data, as it is currently sorted, to a disk file (named "SUMMARY.DS1"). This file will be located in the DRIVE and PATH as displayed on line 2 of the screen. - If a file named "SUMMARY.DS1" already exists, you will be given the option to either OVERWRITE the existing file or to append the current data onto the end of the existing disk file. User Instructions for DirStat V1.00 - Revised 10/23/92 F8 - Sends a copy of the summary data, as it is currently sorted, to the printer at LPT1. F9 - Brings up a menu allowing you to change the number of screen rows currently being displayed. The valid choices are 25, 43, or 50. - NOTE: DirStat will NOT check your hardware to see if your system physically supports these screen modes. - NOTE: See also the section above on "Syntax and Command Line Parms". F10 - Loads the file details for any EXTension you specify (see section below, "Detail Data" PGUP, PGDN, HOME, END all move you around the display of summary data, assuming there is too much of it to fit on the screen at one time. INS - Allows you to specify a different DOS DRIVE and PATH to read and work with. ESC - Exits the DirStat program. User Instructions for DirStat V1.00 - Revised 10/23/92 Detail Data: ------------ When you press F10 from the DirStat Main Menu, you are asked to specify one of the EXTension names shown in the leftmost screen display column. When you do, DirStat loads all the files (from the DRIVE and PATH shown on screen line 2), and presents you with a screen similar to the following: <*> Dirstat Directory Utility Program V1.00 - FreeWare by Steve Dunn <*> Path: F:\WIN31\*.* Files: 181 EXTs: 24 Bytes: 8,039,239 --- Filename.EXT Size Date Time ---╓─────────────────────────╖ 1 APPS .HLP 15,694 03-10-1992 03:10 ║ [*] DETAIL Menu [*] ║ 2 BIOGRAF .HLP 27,946 08-12-1992 01:01 ╟─────────────────────────╢ 3 CALC .HLP 18,076 03-10-1992 03:10 ║[F1] Sort by NAME ║ 4 CALENDAR.HLP 20,656 03-10-1992 03:10 ║[F2] Sort by SIZE ║ 5 CARDFILE.HLP 24,810 03-10-1992 03:10 ║[F3] Sort by DATE ║ 6 CHARMAP .HLP 10,797 03-10-1992 03:10 ║[F4] Shell to LIST ║ 7 CLIPBRD .HLP 13,071 03-10-1992 03:10 ║[F5] DELETE a File ║ 8 CONTROL .HLP 121,672 03-10-1992 03:10 ║[F6] Sort ASCENDING ║ 9 GLOSSARY.HLP 46,570 03-10-1992 03:10 ║[F7] Print data to FILE ║ 10 HOTSPOT .HLP 9,978 04-02-1992 22:18 ║[F8] Print data to LPT1 ║ 11 MORECON .HLP 5,872 05-16-1992 17:04 ║[F9] Change Screen Rows ║ 12 MPLAYER .HLP 12,896 03-10-1992 03:10 ║[F10] EXIT DirStat ║ 13 NOTEPAD .HLP 13,894 03-10-1992 03:10 ╟─────────────────────────╢ 14 PACKAGER.HLP 21,156 03-10-1992 03:10 ║[PGUP] Show Prev Page ║ 15 PBRUSH .HLP 40,269 03-10-1992 03:10 ║[PGDN] Show Next Page ║ 16 PIFEDIT .HLP 33,270 03-10-1992 03:10 ║[HOME] Show 1st Page ║ 17 POINT .HLP 39,542 03-10-1992 08:20 ║[END] Show Last Page ║ 18 PRINTMAN.HLP 40,880 03-10-1992 03:10 ╟─────────────────────────╢ 19 PROGMAN .HLP 30,911 03-10-1992 03:10 ║[ESC] Back to Main Menu ║ 20 PSP .HLP 150,877 03-09-1992 08:05 ╙─────────────────────────╜ Line 1: - The program name, version number, and personal plug! Line 2: - The DRIVE and PATH currently being displayed. Note that the "*.*" is added automatically for you and should NOT be included on the DOS command line. Line 3: - Summary data on the DRIVE and PATH hilighted on line 2 - Files = total number of files in the DRIVE and PATH, including Hidden, Read-Only, etc files. EXTs = the number of different and unique filename EXTensions found in the DRIVE and PATH. Bytes = the total number of bytes in all the files found in the DRIVE and PATH (this is the DOS File size, not the number of bytes in occupied disk clusters). User Instructions for DirStat V1.00 - Revised 10/23/92 Directly beneath this screen header data, on the lefthand side of the display screen, is a list of each file matching the EXTension name you originally specified, defined as follows: The leftmost column contains an identifier number used by DirStat (which also allows you to see exactly where you are on the display of detailed data). The next column (Filename.EXT) contains the full filename and EXTension, as it would appear in DOS DIR lists. Note that all the EXTensions will be identical (naturally). The next column (Size) displays the number of bytes in each file (again, the DOS file size, not the amount in occupied clusters) formatted for easier reading. The next column (Date) contains the DOS file date (the date on which the file was last affected). The final column (Time) contains the DOS file time (the time at which the file was last affected). Note that, originally, this data is unsorted - the EXT names are presented in the order in which they are encountered in the DOS directory listing. The menu on the right hand side of the screen allows you to re-arrange the detailed data into more useful formats, as follows: F6 - Switches SORT order between ascending and descending. F1 - Sorts the display alphabetically by filename F2 - Sorts the display numerically by file size in bytes. F3 - Sorts the display by the DOS file date. F4 - Shells to DOS, invoking a command named "LIST" and passing to it the DOS DRIVE, PATH, and FILENAME.EXT (you are first asked to specify a particular file by entering its "number" from the leftmost column). - This is supposed to allow you to view the contents of a specific file, and ASSUMES you have an appropriate file viewing utility program named "LIST". DirStat does not provide any file viewing capabilities of its own. User Instructions for DirStat V1.00 - Revised 10/23/92 F5 - Deletes a file you specify by giving its "number" from the leftmost column. - NOTE: - If you enter a "9999" here, DirStat will delete ALL FILES CURRENTLY DISPLAYED, AND WILL RETURN YOU TO THE SUMMARY DATA SCREEN (which will be adjusted to reflect the changes you just made). - CAUTION: DirStat will delete HIDDEN and READ ONLY files along with any other type file it finds. F7 - Prints the display data, as it is currently sorted, to a disk file in the DRIVE and PATH on screen line 2 named "???FILES.DS1", where the three ?'s are replaced by the EXTension name you are currently viewing. - If a file already exists with the same name and EXTension, DirStat will give you the option of either OVERWRITING the existing file, or merely APPENDING the current display data to the existing file F8 - Sends a listing of the display data, as it is currently sorted, to the printer at LPT1. F9 - Brings up a menu allowing you to change the number of screen rows currently being displayed. The valid choices are 25, 43, or 50. - NOTE: DirStat will NOT check your hardware to see if your system physically supports these screen modes. - NOTE: See also the section above on "Syntax and Command Line Parms". F10 - Exit the DirStat program. PGUP, PGDN, HOME, END all move you around the display of detail data, assuming there is too much of it to fit on the screen at one time. ESC - Takes you back to the Summary Data display screen. User Instructions for DirStat V1.00 - Revised 10/23/92 Version History: --------------- Version 1.00 was originally released to the public on 10/23/92. New Versions: ------------ New versions are uploaded originally to CompuServe IBMSYS forum, Library 5, and to "CHANNEL 1" BBS in Boston, MA. What next: --------- What features would YOU like to see in future versions of DirStat?